Issue Linking Reminder

This PR doesn't appear to have a linked issue. Consider linking to:

• This repo: Closes #123
• ralph-ideas: Closes multivmlabs/ralph-ideas#123

Using Closes, Fixes, or Resolves will auto-close the issue when this PR is merged.

If this PR doesn't need an issue, you can ignore this message.

Greptile Summary

This PR adds a single English-language, SEO-optimised blog post (2026-03-07-figma-to-code-visual-validation.md) describing the new ralph-starter figma interactive wizard and three-layer visual validation pipeline introduced in v0.4.0. The post covers the full workflow from pasting a Figma URL through pixel comparison, LLM vision analysis, and strict gate validation, and includes internal links to seven docs pages for SEO.

Key issues found:

• Build-breaking broken link — /docs/cli/figma is referenced in the References section but docs/docs/cli/figma.md does not exist. With onBrokenLinks: 'throw' in docusaurus.config.ts, pnpm build will fail, directly blocking the stated test-plan item.
• Duplicate social/OG image — image: /img/blog/figma-to-code.png is already used by the existing post 2026-02-01-figma-to-code-one-command.md, making both posts visually identical when shared on social media.
• Missing Figma API token prerequisite — The "Try it" section guides readers straight to ralph-starter figma without mentioning that a Figma Personal Access Token must be configured first (ralph-starter config set figma.token figd_...), which will cause a first-run authentication error.

Confidence Score: 2/5

• Not safe to merge — the broken /docs/cli/figma link will cause pnpm build to fail due to onBrokenLinks: 'throw'.
• The post is a docs-only change with no code risk, but it contains a broken internal link to a page that does not exist (/docs/cli/figma). The Docusaurus configuration throws on broken links, so this will cause the CI build to fail before the post is ever published. The issue is straightforward to fix — either create the missing page or swap the link for the existing /docs/sources/figma reference.
• docs/blog/2026-03-07-figma-to-code-visual-validation.md — specifically line 160 where the broken /docs/cli/figma reference lives.

Important Files Changed

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[ralph-starter figma] --> B[Interactive Wizard\nURL · description · stack · model]
    B --> C[Figma API extraction\ntypography · colors · spacing · assets]
    C --> D[AI Agent coding loop\nwrite → lint → build → commit]
    D --> E[Layer 1: pixelmatch\npixel diff < 2%?]
    E -->|Yes| F[✓ Visual validation passed]
    E -->|No - diff ≥ 2%| G[Layer 2: LLM vision analysis\nFigma screenshot + impl screenshot + diff overlay]
    G --> H[Agent applies fixes]
    H --> I[Layer 3: Strict pixelmatch gate\npixel diff < 2%?]
    I -->|Yes| F
    I -->|No| G

_{Last reviewed commit: 83c3c22}

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

🔗 Docs Preview

Preview URL: https://content-english-blog-v040.ralph-starter-docs.pages.dev

This preview was deployed from the latest commit on this PR.

This PR has been automatically marked as stale because it has not had recent activity.
It will be closed in 7 days if no further activity occurs.
Please update or comment if this PR is still in progress.